home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / disk / misc / xfs208b.readme < prev   
Text File  |  1998-01-05  |  14KB  |  347 lines
  1. Short:    Multi filesys+.device, pc+pcw+minix+more
  2. Author:   frans (francis swift)
  3. Type:     disk/misc
  4. Replaces: xfs207b2
  5.  
  6. --------------------------- xfs208b ----------------------------
  7.  
  8. MINIX FileSystem now working (read-only).
  9.  
  10. New system for enabling/disabling the mounting of volumes, and
  11. for disabling recognition of certain disks (no more xfsd-ami)
  12.  
  13. ...see mount.xfsd for details
  14.  
  15. CPM3 Filesystem (well PCW 3.5 inch 720K disks) (read-only)
  16.  
  17. I have precisely one PCW disk and it works perfectly, so there.
  18.  
  19. Sorry, the mac handler just recognises that the disk is indeed a
  20. Mac disk, reads the volume name, then just sits there and refuses
  21. to do anything else. Maybe next time.
  22.  
  23. --------------------------- xfs207b2 ----------------------------
  24. ALL NEW INTRO!!!
  25.  
  26. Well, just a few extra words.
  27.  
  28. Ther was a hash clash (try saying that quickly) in the internal
  29. name cache (or should that be hash cache?) between the short names
  30. and the long names. Basically, the dummy short name entries were
  31. displacing the true long name entries, thus losing all the internal
  32. pointers etc, so the directory listings (which don't use the name
  33. cache) showed all the files, but the handler couldn't access them.
  34.  
  35. I'm still working on the MAC handler, based on code from the
  36. hfsutils package on linux, written by Robert Leslie.
  37. Hopefully, because I'm basing it on working code, it should work
  38. as a complete read/write handler as soon as it's finished :-)
  39.  
  40. EXTRA BONUS  *** x-hfsdir ***  EXTRA BONUS
  41.  
  42. Mount DEV: (you've already got it - see the mount list for details)
  43. then you can get a directory of a MAC disk with
  44.  
  45. x-hfsdir dev:mfm.device,1
  46.  
  47. or, if there's a subdirectory called hyper
  48.  
  49. x-hfsdir dev:mfm.device,1 hyper
  50.  
  51. and a subdirectory in there called new
  52.  
  53. x-hfsdir dev:mfm.device,1 hyper/new
  54.  
  55. you get the picture, just remember the ,1 means drive unit 1 (df1:)
  56.  
  57. --------------------------- xfs207b -----------------------------
  58.  
  59. FD.DEVICE and XFSD HANDLER
  60.  
  61. This is a powerful Amiga device and handler combination which allows
  62. any drive to read more than a dozen formats, all accessed via a single
  63. desktop icon and drive name - regardless of the system that originally
  64. wrote the disk.
  65.  
  66. This is the product of years of development by the author of
  67. QL_Handler (for Qdos disks) and SP_Handler (for Spectrum disks)
  68. which are included in the Qdos4Amiga and Speculator97 distributions.
  69. Like all Frank Swift's Amiga programs, it is freely distributable.
  70.  
  71. It is a response to the way icons could proliferate on the desktop
  72. with lots of handlers connected to each drive, in case a particular
  73. format disk was inserted. The recognition of disks became slow and
  74. handlers clashed in their interpretation of the disk format. There
  75. had to be a better way. This is it. It's much faster than multiple
  76. handlers, and more reliable too. It reads more formats than before,
  77. including some - like Windows95 long file names and Archimedes E
  78. format disks - which have not previously been supported by Amigas.
  79.  
  80. This program is free and supplied without warranty. If it doesn't
  81. work for you, remember how much you paid for it.
  82.  
  83. As often seems to happen, Simon Goodwin has ended up writing the
  84. documentation. This is a bit of a rush job, so if you'd like
  85. more documentation, send (constructive) comments to:
  86.  
  87.     simon@studio.woden.com
  88.  
  89. All technical comments and suggestions should go to the author,
  90. Frank Swift, who lives in the pre-modem world, where he can still
  91. get some real work done ;-) His snail-mail address is:
  92.  
  93.     325 Charlestown Road, Blackley, Manchester M9 7ES, UK.
  94.  
  95. Friendly feedback from users would be much appreciated.
  96.  
  97.  
  98.  
  99. Features
  100.  
  101. * A single Handler and device that reads the following formats:
  102.  
  103. Name           System                Make/Model
  104.  
  105. Acorn          Archimedes E format   Acorn Computers
  106. Amiga OFS      Workbench 1.x         Commodore
  107. Amiga FFS      Workbench 2.xx        Commodore
  108. Amiga FFS/DC   Workbench 3.xx        Commodore/Gateway
  109. Atari ST/TT    TOS 1, TOS 2 etc.     Atari Corporation
  110. BetaDOS        Spectrum and +D       BetaSoft
  111. Diskspare      Amiga custom          High capacity format
  112. GDOS           Sinclair Spectrum     MGT Disciple Interface
  113. G+DOS          Sinclair Spectrum     MGT/Datel +D interface
  114. MasterDOS      SAM Coupe             MGT and BetaSoft
  115. MSDOS          IBM PCs and clones    Microsoft licensees
  116. MSXDOS         All MSX disk micros   Sony, Toshiba etc.
  117. QDOS           QL & clones           Sinclair, CST, Miracle
  118. SAMDOS         SAM Coupe             Miles Gordon Technology
  119. Windows95/NT   Intel boxes & clones  Anyone with the $$$$$$$
  120.  
  121. Support for CP/M formats (particularly Amstrad PCW and Plus 3)
  122. and Apple Mac is hoped to follow if you make encouraging noises
  123. to the author. All other suggestions will be considered, as long
  124. as you can provide documentation of the low level and logical
  125. formats you'd like added. The intention is to make fd.device
  126. flexible enough to cope with any format the Amiga can access,
  127. including FM & GCR encodings and multiple sector-sizes per track.
  128. (CHIEF ENGINEER SCOTT: "mac handler in a couple of weeks, cap'n").
  129.  
  130. * Currently fd.device understands amiga style tracks (both normal
  131. and diskspare types) and pc style tracks (in most of the common
  132. sector sizes, eg 128, 256, 512, 1024, 2048 etc).
  133.  
  134. * Compatible with ALL Amiga systems from Workbench 1.2 to 3.1,
  135. so you can format OFS disks on an A4000, and read FFS DC ones
  136. on an old A500!
  137.  
  138. * Compatible with HD (High Density) drives as well as DD ones,
  139. and odd media sizes like 3 inch and 5.25 inch drives.
  140.  
  141. * Supports Windows95 long file names (and would write them too
  142. by now if Micro$oft hadn't found such an absurd way to add
  143. them to the MSDOS format!)
  144.  
  145. * Includes FILE0 and FILE1 icons that allow floppy disk images
  146. to be manipulated as files (containing a whole disk's contents)
  147. on other media, e.g. RAM or hard drive. If you can't see the
  148. point of this, you needn't worry about it. Just leave the icons
  149. where they are.
  150.  
  151.  
  152.  
  153. Limitations
  154.  
  155. Format disk works but always uses the format that the disk is already
  156. in - so you can't use XFileSystem to change the formatting of a disk.
  157. We have yet to work out a good way to indicate the desired format
  158. when there are so many possibilities, including various capacities
  159. for a given format: for instance single sided 360K ST, double sided
  160. 720K Mega ST and 1.44 Mb Atari TT formats...
  161.  
  162. This is the first release. Writing has only been extensively tested
  163. on Qdos format disks (DD and HD) and is not yet supported on Spectrum
  164. and PC formats. If you try it a seek error is the likely result. The
  165. disk contents will not be changed, but don't trust XFileSystem to
  166. your only copy of a file, just in case. You have been warned!
  167.  
  168. The wonderful CatWeasel disk controller is not supported because its
  169. MultiDisk device requires the user to decide the format of each disk,
  170. rather than letting the sytstem work it out for itself. The original
  171. QL_Handler and SP_Handler do work rather well with CatWeasel, though.
  172.  
  173.  
  174.  
  175. Installation (at last!)
  176.  
  177. The package is divided in standard Amiga style into two parts - a
  178. 'handler', XFSD which recognises the logical format of disks (the
  179. directory and file details) and a 'device', fd.device, which reads
  180. the disk tracks and decodes them into individual data 'sectors'.
  181.  
  182. There is a special version, XFSD-AMI, which includes support for
  183. the Amiga file structures. Normally this is not needed - you can
  184. use the DF0:, etc. icons as normal - but if you want the FD icon
  185. to recognise Amiga Diskspare, OFS or FFS disks you must copy the
  186. xfsd-ami version to directory L: renaming it to remove the -ami,
  187. in place of the standard xfsd which only reads 'alien' formats.
  188. However, if you use a normal amiga disk with this handler _both_
  189. the normal amiga handler _and_  xfsd would recognise it and try
  190. to mount the volume. Tricky. But see the mountlist for a sneaky
  191. workaround if you want to experiment.
  192.  
  193. The handler can be manually installed from Shell, Opus, Workbench
  194. etc. as follows;
  195.  
  196. Open the drawer "L" in the XFS directory and drag the program "xfsd"
  197. to your system "L:" drawer.
  198.  
  199. Open the drawer "DEVS" in the XFS directory and drag the program
  200. "fd.device" to your system "DEVS:" drawer.
  201.  
  202. Both files must be in the correct directory or the handler will not
  203. work. This is the most common reason people can't get new devices
  204. and handlers to work.
  205.  
  206. The procedure to give these programs access to your drives depends
  207. on your version of Workbench. Modern Amigas have a DEVS:DOSDRIVERS
  208. drawer which contains a 'setup' icon for each desktop drive icon.
  209. If you have an old system (such as Workbench 1.3) you'll need to
  210. edit your startup-sequence (user-startup on Workbench 2) file in
  211. the S: directory to 'mount' the devvice and handler on chosen drives.
  212.  
  213.  
  214. Procedure for Workbench 2.1 and later
  215.  
  216. Drag the icons FD0: and FD1: from "Devs/DOSDrivers" to your system
  217. "Storage/DOSDrivers" drawer or "Devices/DOSDrivers" drawer. The second
  218. choice will mount the X handler every time you reboot the system,
  219. allowing relatively instant access.
  220.  
  221. The handler is manually activated by double clicking the FD0: or FD1:
  222. icon in the Storage sub-directory. This makes the corresponding FD:
  223. icon appear on the desktop. Other programs can read the disk, whatever
  224. the format, by using the drive name prefix FD instead of DF. There are
  225. icons for two drives supplied; you can edit these by changing the name
  226. and UNIT number inside if you have more than two drives, e.g. UNIT=3
  227. for FD3: etc.
  228.  
  229. If you want the handlers to be activated automatically on start-up then
  230. they should be put in your system "Devs:DOSDrivers" drawer.
  231.  
  232.  
  233. Procedure for old Workbenches
  234.  
  235. Copy the mountlist.xfsd file to DEVS: and add a line to your startup
  236. for each drive you want to connect to XFS, as follows:
  237.  
  238. MOUNT FD0: FROM DEVS:mountlist.xfsd
  239.  
  240. MOUNT FD1: FROM DEVS:mountlist.xfsd
  241.  
  242. etcetera for up to four drives (FD0: FD1: FD2: and FD3: corresponding
  243. to DF0: to DF3: respectively).
  244.  
  245. If you just want to try it, without changing your startup, put the XFSD
  246. and fd.device files in the required directories (L: and DEVS:, remember)
  247. and type one of the above 'Mount' commands into a shell, or into the
  248. Workbench 2 'Execute Command' window (if you've got it).
  249.  
  250. ------------------------------------------------------------------------
  251. EXTRA EXTRA ............ fd.device / file.device ............ STOP PRESS
  252.  
  253. Disk recognition
  254.  
  255. As if all this was not enough, fd.device inserts an input stream handler
  256. to allow you to force it to re-read the disk, at the same time sending a
  257. disk change interrupt to whatever dos handler is using it.
  258.  
  259. The key combination(s) for fd.device are
  260.  
  261.     left_alt + numeric_pad(unit#)
  262.  
  263. ie left alt with numeric pad 0 would force a disk change on unit 0.
  264.  
  265. The same is true for the file.device, although in this case it also allows
  266. you to select another disk image file for access, via a requester.
  267.  
  268. The key combination(s) for file.device are
  269.  
  270.     left_alt + left_shift + numeric_pad(unit#)
  271.  
  272. ie left alt plus left shift plus numeric pad 1 would force a disk change
  273. on unit 1.
  274.  
  275. NOTEZ BIEN
  276.  
  277. This key usage may change - especially the particular key combinations
  278. (because they may clash with other programs).
  279.  
  280. ------------------------------------------------------------------------
  281.  
  282. POWER XL
  283.  
  284. The current fd.device doesn't work with the Power XL high density drive,
  285. but I'm pretty sure it's fixable. In the meantime I've included an
  286. earlier version (fd.device.old) that seems to work ok. If you need it,
  287. just rename it to fd.device and put it in devs:
  288. Unfortunately the geometry command doesn't work with this version :-(
  289.  
  290. RAWPATCH / MFM
  291. --------------
  292. Two utilities to experiment with raw disk data. So obscure as to be
  293. almost unusable. Use rawpatch to read in raw track data, then mfm to
  294. decode it.
  295. Hint: ALWAYS use -I -W with rawpatch (index sync & word sync). At the
  296. very least mfm likes its input wordsync'ed, and you can only get an
  297. idea of the sector skewing if you read starting from the index pulse.
  298. Hint: use -v on mfm to get a verbose output (or even -vv ).
  299.  
  300. GEOMETRY
  301. --------
  302. This program sends a TD_GETGEOMETRY command to any device to find out
  303. the media layout AND with fd.device it gets some hidden extra
  304. information about the interleave, skew factors etc.
  305.  
  306. CRC
  307. ---
  308. Just a simple program to generate CRC's for files, but I've added an
  309. option to generate a CRC for each block (by using eg -b512), which by
  310. default is the one used on disk sectors (pc MFM that is, not amiga style).
  311.  
  312.  
  313. Frank Swift and Simon N Goodwin, Manchester and Oldbury, UK, August 1997.
  314.  
  315.  
  316. ============================= Archive contents =============================
  317.  
  318. Original  Packed Ratio    Date     Time    Name
  319. -------- ------- ----- --------- --------  -------------
  320.    12108    8275 31.6% 14-Nov-97 20:51:26 +crc
  321.       85      85  0.0% 13-Mar-97 05:31:50 +DEV
  322.      481     263 45.3% 05-Jul-94 21:38:14 +DEV.info
  323.     5728    3304 42.3% 21-Sep-97 17:41:54 +devd
  324.    17364    9931 42.8% 23-Sep-97 00:07:32 +fd.device
  325.    16404    9392 42.7% 07-May-97 07:15:18 +fd.device.old
  326.      789     446 43.4% 16-Nov-97 17:09:58 +FD0
  327.      492     274 44.3% 13-Jan-95 00:38:04 +FD0.info
  328.      780     438 43.8% 16-Nov-97 17:10:08 +FD1
  329.      492     271 44.9% 13-Jan-95 00:38:04 +FD1.info
  330.    17384   10182 41.4% 14-Sep-97 17:39:00 +file.device
  331.      501     297 40.7% 16-Nov-97 17:11:42 +FILE0
  332.      492     274 44.3% 13-Jan-95 00:38:04 +FILE0.info
  333.      501     297 40.7% 16-Nov-97 17:11:50 +FILE1
  334.      492     271 44.9% 13-Jan-95 00:38:04 +FILE1.info
  335.     8728    5054 42.0% 23-Sep-97 00:02:38 +geometry
  336.    21020   11730 44.1% 11-Apr-97 07:07:26 +mfm
  337.      915     487 46.7% 16-Nov-97 17:02:04 +mount.dev
  338.     1577     389 75.3% 09-Nov-97 16:54:00 +mount.file
  339.     5211    1349 74.1% 14-Dec-97 17:38:18 +mount.xfsd
  340.    13764    8070 41.3% 31-Mar-97 18:35:12 +rawpatch
  341.    42088   22060 47.5% 30-Nov-97 16:55:22 +x-hfsdir
  342.    12489    5606 55.1% 14-Dec-97 18:02:52 +xfs208b.readme
  343.    67476   36795 45.4% 14-Dec-97 17:50:52 +xfsd
  344.    58804   32004 45.5% 30-Nov-97 17:57:32 +xfsd-ami
  345. -------- ------- ----- --------- --------
  346.   306165  167544 45.2% 20-Dec-97 16:36:44   25 files
  347.